GET
/
tariffs
/
{id}
/
[BETA] Get detailed tariff information
curl --request GET \
  --url https://sandbox.prezio.eu/api/tariffs/{id}/ \
  --header 'Authorization: <api-key>'
{
  "id": "tar_45",
  "name": "Advanced Business Tariff",
  "has_time_of_use": true,
  "has_tiers": true,
  "has_calculation_input": true,
  "has_properties": true,
  "context": {
    "country": {
      "code": "DK",
      "timezone_default": "Europe/Copenhagen",
      "currency": "DKK"
    },
    "organization": {
      "id": "org_285",
      "name": "Copenhagen DSO",
      "type": "DSO"
    },
    "consumer_types": [
      "BUSINESS",
      "RESIDENTIAL"
    ],
    "main_tariff": {
      "id": "mta_33",
      "name": "Advanced Pricing",
      "description": "Time-variable pricing with demand components"
    }
  },
  "tariff_properties": [
    {
      "id": "pro_15",
      "key": "contract_type",
      "name": "Contract Type",
      "data_type": "CHOICE",
      "group_key": "tariff_type",
      "group_name": "Tariff Type",
      "question": "What type of electricity contract do you prefer?",
      "description": "Different pricing structures available",
      "choices": [
        {
          "id": "prv_13",
          "name": "Spot",
          "value": "spot"
        }
      ]
    },
    {
      "id": "pro_16",
      "key": "price_duration",
      "name": "Price Variability Duration",
      "data_type": "CHOICE",
      "group_key": "tariff_type",
      "group_name": "Tariff Type",
      "question": "How often do you want price updates?",
      "description": "Frequency of price changes",
      "choices": [
        {
          "id": "prv_41",
          "name": "Hourly",
          "value": "1h"
        }
      ]
    }
  ],
  "tou_levels": [
    {
      "id": "tou_146",
      "name": "Peak",
      "type": "ON_PEAK",
      "periods": [
        {
          "from_time": "17:00",
          "to_time": "20:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 17:00-20:59"
        }
      ]
    },
    {
      "id": "tou_162",
      "name": "Partial peak",
      "type": "PARTIAL_PEAK",
      "periods": [
        {
          "from_time": "05:00",
          "to_time": "16:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 05:00-16:59"
        },
        {
          "from_time": "21:00",
          "to_time": "23:59",
          "from_day": 1,
          "to_day": 5,
          "summary": "Mon-Fri: 21:00-23:59"
        }
      ]
    },
    {
      "id": "tou_145",
      "name": "Off-peak",
      "type": "OFF_PEAK",
      "periods": [
        {
          "from_time": "00:00",
          "to_time": "04:59",
          "from_day": 1,
          "to_day": 0,
          "summary": "Mon-Sun: 00:00-04:59"
        }
      ]
    }
  ],
  "components": [
    {
      "id": "com_1889",
      "name": "TOU Demand",
      "key": "tou_demand",
      "description": "Time-of-use demand charge",
      "type": "DEMAND",
      "unit": "kw_per_month",
      "direction": "IMP",
      "has_time_of_use": true,
      "has_tiers": false,
      "has_calculation_input": true,
      "has_properties": false,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": "2025-12-31T23:59:59+01:00",
      "calculation_requirements": [
        {
          "type": "CALCULATION_INPUT",
          "key": "peak_demand",
          "name": "Peak Demand",
          "input_unit": "KW",
          "input_period": "MONTH",
          "choices": [
            {
              "key": "peak_demand_single",
              "type": "SINGLE_VALUE"
            }
          ]
        },
        {
          "type": "TOU_LEVEL",
          "key": "tou",
          "name": "Time of Use Level",
          "choices": [
            {
              "id": "tou_146",
              "type": "ON_PEAK"
            },
            {
              "id": "tou_162",
              "type": "PARTIAL_PEAK"
            },
            {
              "id": "tou_145",
              "type": "OFF_PEAK"
            }
          ]
        }
      ]
    },
    {
      "id": "com_15555",
      "name": "Energy Consumption (kWh)",
      "key": "kwh",
      "description": "Variable energy consumption charge",
      "type": "KWH",
      "unit": "kwh",
      "direction": "IMP",
      "has_time_of_use": true,
      "has_tiers": false,
      "has_calculation_input": true,
      "has_properties": true,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": null,
      "calculation_requirements": [
        {
          "type": "CALCULATION_INPUT",
          "key": "consumption",
          "name": "Energy Consumption (kWh)",
          "input_unit": "KWH",
          "input_period": null,
          "choices": [
            {
              "key": "consumption_profile",
              "type": "TIME_SERIES"
            },
            {
              "key": "consumption_total",
              "type": "SINGLE_VALUE"
            }
          ]
        },
        {
          "type": "TOU_LEVEL",
          "key": "tou",
          "name": "Time of Use Level",
          "choices": [
            {
              "id": "tou_146",
              "type": "ON_PEAK"
            },
            {
              "id": "tou_162",
              "type": "PARTIAL_PEAK"
            },
            {
              "id": "tou_145",
              "type": "OFF_PEAK"
            }
          ]
        }
      ]
    },
    {
      "id": "com_15552",
      "name": "Capacity Fuses",
      "key": "capacity_fuses",
      "description": "Fixed charge based on fuse level",
      "type": "FIXED",
      "unit": "per_month",
      "direction": "IMP",
      "has_time_of_use": false,
      "has_tiers": false,
      "has_calculation_input": false,
      "has_properties": true,
      "applicable_vat_rate": "standard",
      "from": "2025-01-01T00:00:00+01:00",
      "to": null,
      "calculation_requirements": [
        {
          "type": "PRICE_PROPERTY",
          "key": "fuse_level",
          "name": "Fuse Level",
          "data_type": "CHOICE",
          "choices": [
            "16",
            "20",
            "25"
          ]
        }
      ]
    },
    {
      "id": "com_15551",
      "name": "Energy Tax",
      "key": "energy_tax",
      "description": "Government energy tax",
      "type": "TAX",
      "unit": "percent",
      "direction": "IMP",
      "has_time_of_use": false,
      "has_tiers": false,
      "has_calculation_input": false,
      "has_properties": false,
      "applicable_vat_rate": "standard",
      "from": "2025-07-01T00:00:00+02:00",
      "to": null
    }
  ]
}

Authorizations

Authorization
string
header
required

Token-based authentication with required prefix "Token"

Path Parameters

id
string
required

Tariff ID with "tar_" prefix or raw integer (e.g., "tar_789", "789")

Query Parameters

include_tariff_properties
boolean

Include tariff_properties (similar to the data from the list endpoint) section in response (default: false)

include_tou_details
boolean

Include detailed information about tou_levels including periods (default: false)

valid_at
string

Filter components to show only those with active prices at the specified datetime. Also determines the validity range shown in component 'from' and 'to' fields, and affects the calculation of tariff-level flags. Format: 'YYYY-MM-DDTHH:MM:SS' (ISO 8601). If not provided, uses current time.

Response

200
application/json

Success - Returns detailed tariff information incl. advanced calculation requirements

Enhanced serializer for detailed tariff retrieval using common mixins